home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / newcli < prev    next >
Encoding:
Text File  |  1996-09-07  |  7.0 KB  |  194 lines
  1.  
  2.  
  3.  
  4.               NewCLI(V1.3 in C:) (v 2x/3x internal)
  5.  
  6.  
  7.  
  8.      NAME
  9.             NewCLI - Start a new interactive CLI on the system 
  10.         display.
  11.  
  12.      SYNOPSIS
  13.         1.3:
  14.     NewCLI [AUX: or CON:hpos/vpos/width/height/windowtitle] 
  15.            [From filename] [CLI] [STACK]
  16.  
  17.         2.x/3.x:
  18.     NewCLI [AUX: or CON:hpos/vpos/width/height/windowtitle/options]
  19.            [From filename]
  20.  
  21.      DESCRIPTION
  22.           
  23.  
  24.             This window support the same gadgets of a regular 
  25.         everyday Workbench window (that is a drag gadget, 
  26.         back/front gadget, sizing and under 2.x/3.x a zoom and 
  27.         close gadget). It can be started with this command as 
  28.         well as by double-clicking on the Workbench icon 'CLI' 
  29.         found in your Systems drawer. Once started, the CLI 
  30.         becomes the active window on the Workbench. It immediatly 
  31.         takes on current directory from which it was started 
  32.         from.
  33.  
  34.             You can open as many CLI windows as your memory 
  35.         allows under 2.x/3.x.  1.3 limits you to 20. Each window 
  36.         will operate completely seperatly from anyother and will 
  37.         be complete with its own environment.
  38.  
  39.             If you do not change the CLI attributes during CLI 
  40.         startup, then it will be named 'New CLI' under 1.3 and 
  41.         'AmigaShellj' in 2.x/3.x.  The task number of the CLI 
  42.         will also be shown.
  43.  
  44.             Each and every CLI will have its own unique task 
  45.         number, just as every application run on the Amiga will 
  46.         be assigned its own task number. It will be numbered 
  47.         according to how many programs are running at the time 
  48.         you open it. For instance, if you have absolutly NO other 
  49.         applications running it will be task number 1, if there 
  50.         are two other applications running it will be task number 
  51.         3, etc. 
  52.  
  53.             Unless you specify during the start of the CLI 
  54.         process, each CLI will open at the top left corner of the 
  55.         screen and extend 640 pixels accross and 100 pixels down 
  56.         the screen. So, as you open each new CLI, it will cover 
  57.         up the old one unless you manually drag it out of the 
  58.         way.
  59.  
  60.             The advantage of being able to run multiple CLIs on 
  61.         the Amiga is one of the many attributes that sets it 
  62.         apart from other operating systems.  You can open as many 
  63.         CLIs as you could ever use, with each running its own 
  64.         application or holding information which you may need to 
  65.         reference.  If you take a few minutes to master the CLI, 
  66.         you will be able to run rings around anything that an IBM 
  67.         compatible can spew out.
  68.  
  69.  
  70.     KEYWORDS
  71.  
  72.         [AUX: or CON:hpos/vpos/width/height/windowtitle/options]
  73.         [FROM filename]
  74.  
  75.             Using CON: lets you chose the size, postion, and the 
  76.         name of the new CLI window. (NEWCON: was added under 1.3 
  77.         which has advanced functions which may replace CON:) If 
  78.         you want to change the size, postion, or name of the CLI, 
  79.         the CON: (or NEWCON:) keyword must be used.
  80.  
  81.         -hpos:
  82.  
  83.             The horizontal position of the top left corner of 
  84.         your CLI. It is defaulted to 0.
  85.  
  86.         -vpos: 
  87.  
  88.             The verticle postion of the top left corner of your 
  89.         CLI. It is defaulted to 0.
  90.  
  91.         -width:
  92.         -height:
  93.  
  94.             These two keywords have no defaults and must be 
  95.         included for the CON: keyword to work. The CLI must be at 
  96.         least 90x25 pixels, but has a maximum of 640x200 pixels. 
  97.         You can also use the sizing gadget on your CLI to change 
  98.         the window size at any time.
  99.  
  100.         -windowtitle:
  101.             This one is completely optional. This lets you chose 
  102.         the name of the CLI as shown in the titlebar. If you 
  103.         don't enter a window title the title space will be blank. 
  104.         Even though you don't have to supply a name, you must 
  105.         include the last slash following the height keyword.
  106.  
  107.         -options: 
  108.  
  109.             2.x/3.x only. These options were added to make the 
  110.         CLI more flexible.  You can add as many or as few options 
  111.         as you desire:
  112.  
  113.             AUTO: The CLI opens immediatly only when the program 
  114.         that started it requres it.
  115.  
  116.             CLOSE: This is on by default. This lets you add the 
  117.         Close gadget in the top left corner of the CLI.
  118.  
  119.             BACKDROP: This lets forces the CLI to open up behind 
  120.         all other windows and cannot be moved, resized, or 
  121.         changed in any way except through using the zoom gadget.
  122.  
  123.             NOBORDER: There are no visible lines surrounding the 
  124.         window. The zoom and size gadgets will still be there, 
  125.         but if you zoom the window to full size, the CLI will 
  126.         dominate your environment and the only way to make it 
  127.         smaller is by closing it.
  128.  
  129.             NODRAG: The window will not let you drag it. The 
  130.         position will remain in the same place always.
  131.  
  132.             NOSIZE: The zoom, close, and size gadgets will 
  133.         disappear when the CLI is started. There will only be a 
  134.         depth gadget.
  135.  
  136.             SCREENname: The CLI will open on a screen with the 
  137.         name you give it.  For instance, if you use the 
  138.         'SCREENveronica' option, the CLI will open up on the 
  139.         public screen named 'veronica'. If 'veronica' does not 
  140.         exist, then this option won't work.
  141.  
  142.             SIMPLE: Allows the text to fill up the CLI window 
  143.         when expanded. This lets you see more information than 
  144.         before. The default is on.
  145.  
  146.             SMART: When the CLI widow is expanded, this option 
  147.         does not allow the old information to be seen. It is the 
  148.         opposite of SIMPLE.
  149.                 
  150.             WAIT: The CLI won't close when the program that 
  151.         created it is closed.  To close the CLI using this 
  152.         option, you must select the close gadget or use the 
  153.         Ctrl-\ key combination.
  154.  
  155.  
  156.             If you direct the output and input of a CLI to the 
  157.         AUX: device if you desire.  By routing the commands 
  158.         through AUX: you are actually sending commands out the 
  159.         serial port. The AUX: CLI will not be able to cancel 
  160.         requestors and only allow you to run text-based programs. 
  161.         Sorry, no GUI here. Of course, you must mount the AUX: 
  162.         device before you can utilize this.
  163.  
  164.         [FROM filename] 
  165.             This lets you open a CLI with the specifications set 
  166.         in a script file located in your s directory. Normally, 
  167.         NewCLI uses the s:CLI-startup script.  But, you can write 
  168.         any script and reference it with this keyword.
  169.  
  170.             Check out s:CLI-startup to get an idea how to set 
  171.         this up.
  172.  
  173.  
  174.     EXAMPLES
  175.  
  176.             1. To create a new CLI that uses the serial port for 
  177.         input and output:
  178.  
  179.             NEWCLI AUX: 
  180.  
  181.         (remember: this only works if AUX: is mounted)
  182.  
  183.  
  184.  
  185.             2. To create a 150x150 CLI in the upper left corner 
  186.         of your screen named 'Debox':
  187.  
  188.             NEWCLI CON://150/150/Debox
  189.  
  190.             3. To create the default CLI (that is, with the upper 
  191.         left corner of a 200x100 window titled 'New CLI':
  192.  
  193.             NEWCLI
  194.